home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Utilities Experience
/
The Utilities Experience - Volume 1.iso
/
software
/
misc
/
o-z
/
pl_2_50
/
plan.lha
/
Planetarium.dok
< prev
next >
Wrap
Text File
|
1995-06-23
|
21KB
|
556 lines
Document Planetarium Dokumentation
Planetarium
FRIENDWARE-Version 2.50
=======================
1. FEATURES
========
- Hohe Konfigurierbarkeit durch ASCII-Dateien
- Bilder für Teleskop-Modus werden automatisch erkannt und eingebunden
- Steuerung über `Tastatur', `DropDownMenü's und `Gadgets'
- Diaschau-Modus
- Double-Buffered-Display! ( -> `BEKANNTE FEHLER:' )
- Multitaskingfreundlich; während das Programm auf Eingaben wartet, wird
sein Task auf 'waiting' gesetzt.
- speichert seine `Standardeinstellungen' am Ende einer Sitzung, sodaß
sie beim nächsten Start sofort wieder zur Verfügung stehen
- kann jederzeit während des Programmlaufes in `andere Sprachen'
umgeschaltet werden
- es werden jetzt auch ausgewählte Messier- bzw. NGC-Objekte angezeigt
2. Anmerkungen
===========
Diese Simulation beruht auf dem von H.Hinkelmann geschriebenen Programm
für den C64, das im Mai 1985 im C64 Magazin, Verlag Markt und Technik,
veröffentlicht wurde.
Ich habe es bei der Übertragung auf den Amiga gründlich überarbeitet,
sowohl was den Programmierstil als auch die Effizienz der Routinen angeht,
wobei ich ausgiebig Gebrauch von der Benutzeroberfläche dieses Computers
gemacht habe. Außerdem fügte ich etliche Funktionen und Sternpositionen
hinzu, sodaß vom ursprünglichen Programm kaum etwas übrig ist, weshalb ich
als Autor zeichne.
Inzwischen ist "Planetarium" recht gut getestet und ich habe sehr viel Zeit
in die Weiterentwicklung gesteckt.
Die neue Version gebe ich als FRIENDWARE frei, d.h. ich erwarte, daß jeder,
der dieses Programm benutzt, mir einen (hoffentlich) freundlichen Gruß zu-
kommen und sich registrieren läßt. (-> `Copyright' )
Eine Registrierung führt dazu, daß bei einer neuen Version automatisch
eine Benachrichtigung durch mich erfolgt. Diese Version kann dann
gegen eine Unkostenbeteiligung (Diskette, Porto) bei mir bezogen werden.
Geld- oder Sachspenden (neuere SF-Romane, CD's, Autos, Häuser...) werden
zwar nicht erwartet, aber durchaus dankend angenommen; ich revanchiere
mich dann mit einer Diskette mit weiterem Material (Bilder, Sourcecode..)
-------------------------------------------------------------------------------
FÜR ETWAIGE SCHÄDEN, DIE DURCH MEIN PROGRAMM AN HARDWARE, SOFTWARE, TUPPERWARE,
GEISTIGER GESUNDHEIT U.S.W. ENTSTEHEN, ÜBERNEHME ICH AUSDRÜCKLICH KEINE
VERANTWORTUNG!!!
-------------------------------------------------------------------------------
Das `Copyright' bleibt beim `Autor' © Rolf Kühr
===============================================
Das Programm wurde ursprünglich auf einem normalen Amiga 2000 mit 1 Megabyte
RAM unter Kickstart 1.3 entwickelt, läuft aber inzwischen auf einem
A 2000 mit 2630 Turbokarte, 1MB Chipram, 6MB Fastram unter Kickstart 2.x
trotz des Unkens der GFA-Basic Gegner problemlos, obgleich einige Programm-
teile gnadenlos von den Libraryroutinen Gebrauch machen.
(-> `BEKANNTE FEHLER:')
Viel Spaß beim Ausprobieren!
3. Inhalt des Programmpaketes
==========================
drei Archivdateien:
~~~~
3.1. 2 Bildarchive
~~~~~~~~~~~~~
TELE1.LHA enthält die Grafiken für den Teleskop-Modus und die Diaschau für
Disketteninstallation
TELE2.LHA enthält zusätzliche Grafiken
3.2. Archiv mit Programm- und Systemdateien
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
PLAN.LHA enthält die Dateien
- Planetarium_2.50 das eigentliche Programm
- Planetarium_2.50.info Programmicon
- Planetarium.c Kompilierte Version (ohne double-
buffering für AGA und langsame Amigas)
- Planetarium.c.info Programmicon
- Planetarium.guide.info Texticon
- Planetarium.guide deutsch/englische Anleitung
- about.eng ASCII-Datei für Info (englisch)
- about.fra ASCII-Datei für Info (französisch)
- about.ger ASCII-Datei für Info (deutsch)
- const.eng ASCII-Datei für Sternbildnamen
- const.fra ASCII-Datei für Sternbildnamen
- const.ger ASCII-Datei für Sternbildnamen
- defstrings.eng ASCII-Datei mit allen vom
Programm benötigten Strings
- defstrings.fra s.o. französische Version
- defstrings.fer s.o. deutsche Version
- preset.data ASCII-Datei für Voreinstellungen
- planet.data ASCII-Datei mit Planetendaten
- starneu.data ASCII-Datei mit Sterndaten
- gfabasro Run-only-Interpreter
sowie
3.3. Hilfsprogramme/Dateien
~~~~~~~~~~~~~~~~~~~~~~
- MuchMore Textanzeigeprogramm
- BITTE_LESEN.info Texticon
- BITTE_LESEN Installationshilfe deutsch
- READ_ME_FIRST.info Texticon
- READ_ME_FIRST Installationshilfe englisch
- Installer Commodores utility
- Install-Planetarium einfaches Installerskript
- Install-Planetarium.info Skripticon
- AmigaGuide Commodore utility
- libs Library-Schublade
- amigaguide.library
- tools Schublade für Hilfsprogramme
- LhA (De-)Archivierungsprogramm
- LhaPatterns Hilfsprogramm
4. Überblick
=========
PLANETARIUM zeichnet eine Sternkarte von Horizont zu Horizont (360 Grad
Rundumsicht), wie sie etwa aus Atlanten bekannt ist, für jeden Ort der
Erde und jeden sinnvollen Zeitpunkt (es rechnet mit dem Julianischen
Kalender).
+----------------------------------------------------------------------+
| Gestartet wird mit der Systemzeit, wobei angenommen wird, |
| daß sich der Computer in der Zeitzone des 1. voreingestellten Ortes |
| befindet. Ist das nicht der Fall, empfiehlt es sich, in der Datei |
| preset.data eine entsprechende Korrektur vorzunehmen!!! |
+----------------------------------------------------------------------+
Zeit und Datum können durch Anwahl des entsprechenden Menupunktes oder
Gadgets geändert werden.
Eine recht große Anzahl von Sternen bis etwa zur 3.Größenklasse wird
angezeigt und durch einige schwächere ergänzt, wo es für die Darstellung
des Sternbildes nötig ist. Hinzugekommen sind einige Galaxien, offene und
kugelförmige Sternhaufen sowie ein paar bekanntere Nebel. In der Regel
sind diese Objekte unter ihrer Messiernummer (z.B. M43) oder NGC-Nummer
eingetragen.
Die Größenklassen bzw. scheinbaren Helligkeiten werden in Grautöne
übersetzt dargestellt, Planeten sind rot markiert.
PLANETARIUM wendet sich in erster Linie an den astronomischen Einsteiger:
Man kann sich mit seiner Hilfe am Firmament orientieren, indem man mit dem
Mauszeiger auf einen Stern oder Planeten deutet und die linke Maustaste
betätigt:
Ein Kreis wird um das Objekt gezeichnet, sein Name und der des Sternbildes
werden angezeigt, während die zu der Konstellation gehörenden Sterne blinken,
solange die Maustaste gedrückt bleibt.
Sucht man einen bestimmten Stern, Sternbild oder Planeten, braucht man nur
"Look for names" im `DropDownMenü' anzuwählen und den Namen oder einen Teil
davon einzugeben; die Anzeige erfolgt wie oben beschrieben. Das gleiche gilt
auch für die anderen astronomischen Objekte. Gibt man beispielsweise
"Galax" ein, so werden alle dem Programm bekannten und zur Beobachtungs-
zeit sichtbaren Spiralnebel blinkend dargestellt. Galaxien, Kugelhaufen,
offene Sternhaufen und Nebel werden also vom Programm wie Sternbilder be-
handelt. Das hat den Vorteil, daß man so einen Eindruck von der Verteilung
der jeweiligen Objekte am Firmament bekommt.
Außerdem kann Planetarium die Bewegung von Himmelsobjekten simulieren.
Wenn man den Planetariummodus anwählt ( `Gadgets' `DropDownMenü') und ein
Intervall von 24h wählt, läßt sich die Bewegung von Planeten, Sonne und Mond
vor dem Fixsternhimmel gut beobachten.
Die zur Beobachtungszeit herrschende Mondphase wird ständig angezeigt.
5. Die Funktionen im Einzelnen
===========================
Die analogen deutschen Bezeichnungen dürften sich von selbst erklären!
5.1. DropDownMenü
~~~~~~~~~~~~
5.1.1. - Programm
--------
- weiter Der Bildschirm wird neu aufgebaut und die Zeit
aktualisiert
- beenden das Programm wird verlassen
- über... blendet Versionsnummer, meine Adresse und einen Copy-
right/Sharewarevermerk, sowie einige Programmdaten ein
5.1.2. - Parameter ändern
----------------
- Position Die Koordinaten eines beliebigen Punktes auf der
Erde können eingegeben werden
- Datum/Zeit Eingabe der Beobachtungszeit (Ortszeit)
- Voreingestellte Orte Die in der ASCII-Datei preset.data
erfaßten Orte können direkt in einem
weiteren Untermenü angewählt werden
- Systemzeit Die Beobachtungszeit wird auf die Systemzeit
zurückgesetzt
5.1.3. - Modus
-----
- Sternkarte Sternkartenmodus (statisch)
- Planetarium Planetariummodus (dynamisch) -> nach einer wählbaren
Verzögerung (delay) wird die Zeit um einen beliebigen
Betrag erhöht (interval). Sonderfunktionen werden
gesperrt!
- Teleskop Teleskopmodus -> Einblenden der Bilder von
angeklickten Himmelsobjekten, sofern diese im
Subdirectory /tele oder dem Volume tele: gespeichert
sind
5.1.4. - Auflösung
---------
- 640*502
wählt die Auflösung des Bildschirms
- 640*251
------------------------------------------------------------------------------
ACHTUNG!! Sollte Ihr Amiga nur über 512 K verfügen, empfiehlt es sich, sofort
nach dem Verschwinden des Einschaltbildes aus dem Resolution-Menu die geringere
Auflösung (640*240) zu wählen; das Programm startet danach automatisch.
Beim regulären Verlassen des Programms wird die Konfiguration automatisch
abgespeichert!
------------------------------------------------------------------------------
5.1.5. - Suche nach
----------
- Namen sucht nach dem Stern oder Sternbild mit einem spezi-
fischen deutschen oder lateinischem Namen; die Namen
können in der Datei star.data editiert werden (An-
passung an andere Sprachen)
5.1.6. - Ausgabe
-------
- hardcopy ändert die Bildschirmfarben auf schwarz-weiß und
druckt den Bildschirm mit dem Prefs-Treiber der
Workbench aus
- Namen in Karte Nach dem Anwählen dieser Option wird unter
jedem angeklickten Objekt zentriert dessen
Name ausgegeben oder wieder gelöscht
5.1.7. - Sprache
-------
- Deutsch wählt innerhalb des laufenden Programms die
entsprechenden Sprachdateien an
- Englisch und schaltet sofort in diese Sprachen
um !
- Französisch
5.2. Gadgets
~~~~~~~
Im rechten unteren Quadranten des Bildes stehen sechs Icons, die die Programm-
steuerung vereinfachen, und ein QUIT- Gadget zur Verfügung:
erste Reihe:
------------
- Uhr Setzen der Beobachtungszeit
- Weltkugel Setzen der Beobachtungsposition
- Drucker Bildschirmhardcopy
zweite Reihe:
-------------
- Lupe Teleskopmodus an/aus
- Projektor Diaschau; alle Bilder, die im Subdirectory /tele oder dem
Volume tele: vorhanden sind, werden angezeigt. Dabei schaltet
ein Klick der linken Maustaste zum nächsten Bild weiter, die
rechte Maustaste beendet die Diaschau.
---> Bilder müssen im ACBM-Format vorliegen <--
---> und ihre Namen müssen auf .pic enden ! <--
- Planetarium Planetariummodus an/aus
dritte Reihe
------------
- QUIT Programm beenden und Einstellungen sichern
Ein Klick auf das Close-Gadget des Fensters beendet ebenfalls das Programm.
5.3. Tastatur
~~~~~~~~
Die Tastaturabkürzungen findet man neben den Optionen in den Dropdownmenüs.
5.4. Andere Sprachen
~~~~~~~~~~~~~~~
Die Strings für die `DropDownMenü's und alle Programm-Meldungen sind in den
Dateien defstrings.xxx enthalten und können mit einem beliebigen Editor ver-
ändert werden. Dabei ist unbedingt darauf zu achten
- daß keine Satzzeichen ( , ; ! - ) gelöscht werden
-------
- daß die Länge der Strings nicht zu stark verändert wird (ausprobieren)
Ich bitte darum, mir etwaige weitere Übersetzungen zuzusenden.
6. Standardeinstellungen
=====================
Wird das Programm normal verlassen, so werden die Einstellungen für Ort,
Auflösung, Sprache u.s.w. im Verzeichnis S: in der Datei plan.prefs
abgespeichert. Beim nächsten Programmstart wird Planetarium sofort ent-
sprechend konfiguriert.
7. BEKANNTE FEHLER:
================
- Im Planetariummodus sollten die Maustasten nicht zu lange ge-
drückt gehalten werden
- Auf AGA-Amigas sind die Farben der geladenen ACBM-Files etwas
merkwürdig
- Läuft mit einigen Commodities nicht zusammen (Screenblanker,
MultiCX), zumindest nicht im Planetariummodus)
Leider ist durch die systemnahe Programmierung die Kompilierung des
Programms mit gepuffertem Bildaufbau zur Zeit nicht möglich, weshalb die nun
beigefügte schnelle Compilerversion ohne Double-Buffering arbeitet.
Ich empfehle den Einsatz dieser Version auf den AGA-Typen oder langsamen
Rechnern, da die Menge der dargestellten astronomischen Objekte sich
nahezu verdoppelt hat.
Sollte unter den geneigten Usern ein GFA_Basic oder Assembler Experte sein,
der mir beim debuggen helfen kann, wäre ich sehr dankbar!!! (->`Autor')
Der Fehler scheint bei der Speicheranforderung zu liegen. Vielleicht kann man
das Kompilat disassemblieren um nachzusehen, welchen Müll der Compiler
da fabriziert.
8. Copyright
=========
ACHTUNG
=======
Das Programmpaket darf nur unverändert und vollständig weitergegeben wer-
den! ===========================
Eventuelle Modifikationen (die natürlich jeder für sich vornehmen darf)
bitte ich mir zuzusenden, damit ich sie gegebenenfalls in die nächste
Version mit aufnehmen kann.
Es darf IN KEINER WEISE KOMMERZIELL GENUTZT, d.h. verkauft oder
sonstwie gewinnbringend eingesetzt werden; die Verbreitung in PD-Serien ist
ausdrücklich gestattet, sofern die Kosten für eine Diskette und eine even-
tuelle Kopiergebühr insgesamt 10,- DM nicht überschreiten!!
Das Copyright verbleibt beim Autor!
-------------------------------------------------------------------------
9. Entwicklungsgeschichte:
=======================
bis Version 0.98 nichts Erwähnenswertes
Version 0,98i (nicht veröffentlicht)
=============
Einige Fehler beseitigt und einige Voreinstellungen für bekannte oder
interessante Orte (Wünnenberg??) eingebaut.
Die MedRes-Auflösung funktioniert jetzt richtig und bei einigen kritischen
Koordinaten (Pole) tritt kein GURU mehr auf.
Ein Freund bat mich um eine englische Version, also habe ich alles so gut
es ging übersetzt - sogar die Variablennamen und Unterprogrammbezeich-
nungen, damit jeder das Programm leichter nachvollziehen kann
(Version 0.98i bedeutet "international", haha).
Version 0.99i (nicht veröffentlicht)
=============
Wo möglich, wurden Floatingpoint- durch Integervariablen ersetzt, was der
Ausführungsgeschwindigkeit zu Gute kam!
Version 1.0i
============
Ich habe die trigonometrischen Funktionen überprüft und auf die schnellen
GFA-Routinen zurückgegriffen, wo Geschwindigkeit wichtiger als Genauigkeit
war. Das hat sich ausgezahlt! Die compilierte Version braucht nur noch
knapp drei Sekunden, um den Sternenhimmel komplett zu berechnen und zu
zeichnen. Ich habe dieser Version die Nummer 1.0 gegeben, da auch nach
längerem Gebrauch keine Fehler auftraten.
Version 1.01i (nicht veröffentlicht)
=============
Ich habe die Palette überarbeitet, um die scheinbare Helligkeit der Sterne
richtig darstellen zu können. Eine Bitplane mehr würde die Ausführung des
Programms um die Hälfte verzögern!
Version 1.02i (nicht veröffentlicht)
=============
Einen kleinen Fehler in der Blinkroutine behoben.
Version 1.1i
============
Ich habe die Berechnung der Mondphasen eingebaut und eine Routine, die
Sternnamen in die Karte einträgt, wenn der Stern angeklickt wird.
Version 1.11i (nicht veröffentlicht)
=============
Statt eines weißen Kreises wird nun ein Bild des Mondes für die Darstel-
lung der Mondphasen benutzt.
Version 1.12i
=============
Der Mond wird nun auch bei geringer Auflösung korrekt gezeigt.
Version 1.13i
=============
Die Abbildungen des Mondes sind nun in den Sourcecode integriert (Inline)
und brauchen nicht mehr nachgeladen zu werden. Durch die Benutzung
der neuesten Version des Interpreters/Compilers (Version 3.52),
treten einige kleinere Bugs nicht mehr auf.
Version 1.15i bis 1.85i (nicht veröffentlicht)
=======================
Programmsteuerung über BooleanGadgets eingebaut, um die Bedienung komfortabler
zu gestalten.
Die Konfiguration des Programms, besonders die Eingabe anderer Default-Orte
ist jetzt durch Änderungen in den entsprechenden ASCII-Dateien für jeden
leicht möglich.
Version 2.0
===========
Der Bildaufbau erfolgt jetzt verdeckt (Double Buffered Display).
Dadurch werden Bewegungen bei Animationen besser erkennbar.
Das Programm rotiert bei Untätigkeit nicht mehr in Warteschleifen, da sein
Task bis zum Auftreten eines Ereignisses angehalten wird.
Version 2.01
============
Die Presets wurden erweitert und einige kleine bugs bei der Gadgetsteuerung
beseitigt.
Version 2.02 (22.01.1994)
============
Ich habe sämtliche Strings für die Menüs und Programm-Meldungen ausgelagert,
um eine Anpassung des Programms an andere Sprachen zu erleichtern und
liefere eine englische, deutsche und französische Fassung mit.
Version 2.03 (21.4.1994)
============
Ich habe den Code etwas gesäubert und die Kurzanleitung, die zu Beginn je-
des Programmlaufes ausgegeben wird, ausgelagert, um auch sie editierbar
zu machen. Englische Version der star.data zugefügt.
Version 2.04 (23.4.1994)
============
Die Korrektur der Systemzeit->Weltzeit Umrechnung war längst überfällig.
Arbeitet jetzt bei allen geographischen Lagen korrekt!
Version 2.50 (22.6.95)
============
Nach langer Zeit ein etwas größeres Update! Weitere kleine bugs wurden be-
seitigt. Das Umschalten in eine andere Sprache ist zu jeder Zeit möglich.
Die Struktur der Sterndatei wurde komplett überarbeitet, aktualisiert
und erweitert. Übersetzte Sternbildnamen werden jetzt aus einer eigenen
Datei eingelesen (spart Platz). Die Gadgetsteuerung funktioniert nun auch
in der geringeren Auflösung.
Mond und Sonne werden in der Karte durch Bilder und nicht mehr durch
einfache Kreise dargestellt.
Dem Programmpaket wurde eine kompilierte Version ohne DoubleBuffering
zugefügt, die auch auf neuen Amigas lauffähig sein sollte.
Am Ende eines Programmlaufes werden die Einstellungen gesichert, sodaß
sie beim Neustart sofort wieder zur Verfügung stehen.
10. Autor
=====
Rolf Kühr
Am Südhang 21
D 33181 Wünnenberg
Tel.: 02953/8701
Inzwischen bin ich auch über das Zerberus-Netz zu erreichen:
Sokrates@MF.ZER